#pragma once

#ifndef __INI_H__
#define __INI_H__

/* Make this header file easier to include in C++ code */
#ifdef __cplusplus
extern "C" {
#endif

#include <stdio.h>

#ifndef INI_ERROR_ON_FILE_OPEN
#define INI_ERROR_ON_FILE_OPEN -1
#endif

#ifndef INI_ERROR_ON_MEMORY_ALLOCATION
#define INI_ERROR_ON_MEMORY_ALLOCATION -2
#endif

#ifndef INI_ERROR_ON_NO_CLOSING_BRACKET_FOUND
#define INI_ERROR_ON_NO_CLOSING_BRACKET_FOUND -3
#endif

#ifndef INI_ERROR_ON_NO_AFFECTATION_OPERATOR_FOUND
#define INI_ERROR_ON_NO_AFFECTATION_OPERATOR_FOUND -4
#endif

/* Parse given INI-style file. May have [section]s, name=value pairs
   (whitespace stripped), and comments starting with ';' (semicolon). Section
   is "" if name=value pair parsed before any section heading. name:value
   pairs are also supported as a concession to Python's ConfigParser.

   For each name=value pair parsed, call handler function with given user
   pointer as well as section, name, and value (data only valid for duration
   of handler call). Handler should return nonzero on success, zero on error.

   Returns 0 on success, line number of first error on parse error (doesn't
   stop on first error), INI_ERROR_ON_FILE_OPEN on file open error, or 
   INI_ERROR_ON_MEMORY_ALLOCATION on memory allocation error (only when
   INI_USE_STACK is zero), or INI_ERROR_ON_NO_CLOSING_BRACKET_FOUND on No ']'
   found on section line, or INI_ERROR_ON_NO_AFFECTATION_OPERATOR_FOUND on
   No '=' or ':' found on name[=:]value line.
*/
int ini_parse(const char* filename,
              int (*handler)(void* user, const char* section,
                             const char* name, const char* value),
              void* user);

/* Same as ini_parse(), but takes a FILE* instead of filename. This doesn't
   close the file when it's finished -- the caller must do that. */
int ini_parse_file(FILE* file,
                   int (*handler)(void* user, const char* section,
                                  const char* name, const char* value),
                   void* user);

/* Nonzero to allow multi-line value parsing, in the style of Python's
   ConfigParser. If allowed, ini_parse() will call the handler with the same
   name for each subsequent line parsed. */
#ifndef INI_ALLOW_MULTILINE
#define INI_ALLOW_MULTILINE 1
#endif

/* Nonzero to allow a UTF-8 BOM sequence (0xEF 0xBB 0xBF) at the start of
   the file. See http://code.google.com/p/inih/issues/detail?id=21 */
#ifndef INI_ALLOW_BOM
#define INI_ALLOW_BOM 1
#endif

/* Nonzero to use stack, zero to use heap (malloc/free). */
#ifndef INI_USE_STACK
#define INI_USE_STACK 1
#endif

/* Stop parsing on first error (default is to keep parsing). */
#ifndef INI_STOP_ON_FIRST_ERROR
#define INI_STOP_ON_FIRST_ERROR 1
#endif

/* Return line number on error (default is to return line number). */
#ifndef INI_RETURN_LINE_NUMBER_ON_ERROR
#define INI_RETURN_LINE_NUMBER_ON_ERROR 0
#endif

/* Maximum line length for any line in INI file. */
#ifndef INI_MAX_LINE
#define INI_MAX_LINE 200
#endif

#ifdef __cplusplus
}
#endif

#endif /* __INI_H__ */